package com.danciyixue.boot.dcyx.service;

import com.danciyixue.boot.dcyx.model.entity.UnitStudyStats;
import com.danciyixue.boot.dcyx.model.form.UnitStudyStatsForm;
import com.danciyixue.boot.dcyx.model.query.UnitStudyStatsQuery;
import com.danciyixue.boot.dcyx.model.vo.UnitStudyStatsVO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 单元学习统计服务类
 *
 * @author youlaitech
 * @since 2025-06-15 16:32
 */
public interface UnitStudyStatsService extends IService<UnitStudyStats> {

    /**
     *单元学习统计分页列表
     *
     * @return {@link IPage<UnitStudyStatsVO>} 单元学习统计分页列表
     */
    IPage<UnitStudyStatsVO> getUnitStudyStatsPage(UnitStudyStatsQuery queryParams);

    /**
     * 获取单元学习统计表单数据
     *
     * @param id 单元学习统计ID
     * @return 单元学习统计表单数据
     */
     UnitStudyStatsForm getUnitStudyStatsFormData(Long id);

    /**
     * 新增单元学习统计
     *
     * @param formData 单元学习统计表单对象
     * @return 是否新增成功
     */
    boolean saveUnitStudyStats(UnitStudyStatsForm formData);

    /**
     * 修改单元学习统计
     *
     * @param id   单元学习统计ID
     * @param formData 单元学习统计表单对象
     * @return 是否修改成功
     */
    boolean updateUnitStudyStats(Long id, UnitStudyStatsForm formData);

    /**
     * 删除单元学习统计
     *
     * @param ids 单元学习统计ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteUnitStudyStatss(String ids);

    /**
     * 根据用户ID和单元ID更新单元学习统计
     * 如果记录不存在则插入新记录，如果存在则更新非空字段
     *
     * @param formData 单元学习统计表单对象
     * @return 是否操作成功
     */
    boolean saveOrUpdateUnitStudyStats(UnitStudyStatsForm formData);

}
